CreateFacet

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODWindowState

CreateFacet
The CreateFacet method creates a facet object.
ODFacet CreateFacet (in ODFrame frame, 
                     in ODShape clipShape, 
                     in ODTransform externalTransform, 
                     in ODCanvas canvas, 
                     in ODCanvas biasCanvas);
frame
A reference to the frame for the facet.
clipShape
A reference to the initial clip shape for the facet.
externalTransform
A reference to the initial external transform for the facet.
canvas
A reference to the canvas the facet should draw to, or kODNULL if identical to the canvas associated with the containing facet.
biasCanvas
A reference to the canvas object to whose coordinate space the geometry is biased, or kODNULL if the geometry is in the standard platform-normal coordinate space.
return value
A reference to the newly created facet object.

DISCUSSION
Your part calls this method to create a root facet (for example, for printing). The frame is defined for the lifetime of the facet object; once set, it cannot be changed.
To create a facet object for a visible embedded frame, your part should call its own display facet's CreateEmbeddedFacet method instead of this method.

SEE ALSO
The ODFacet::CreateEmbeddedFacet method (page 238).
The ODFacet class (page 219).
"Printing the Document" on page 181 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.